home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / web / nuweb / nuweb_ami / ami_nuweb0.87b.readme < prev   
Text File  |  1994-10-09  |  4KB  |  75 lines
  1. Short: NUWEB 0.87b - Literate Programming with LaTeX
  2. Type: dev/misc
  3. Files: ami_nuweb0.87b.lha, ami_nuweb0.87b.readme
  4. Uploader: Andreas Scherer (scherer@genesis.informatik.rwth-aachen.de)
  5. Author: Preston Briggs (preston@cs.rice.edu)
  6.  
  7. This is a version of Preston Brigg's NUWEB system, a simple literate
  8. programming language and tool.  This is revision 0.87b, compiled and
  9. provided with some extra features for the Commodore Amiga.
  10.  
  11. Here is what Preston says:
  12.  
  13.     NUWEB works with any programming language and LaTeX.  I wanted
  14.     to use LaTeX because it supports a multi-level sectioning scheme
  15.     and has facilities for drawing figures.  I wanted to be able to
  16.     work with arbitrary programming languages because my friends and
  17.     I write programs in many languages (and sometimes combinations
  18.     of several languages), e.g., C, Fortran, C++, yacc, lex, Scheme,
  19.     assembly, Postscript, and so forth.
  20.  
  21. This distribution includes the Ami_NuWeb executable, all source files
  22. (web and C), documentation and the (short) .dvi output of the user manual.
  23.  
  24. Contents:
  25.   Ami_NuWeb    The executable for any Amiga hardware, supports coprocessor
  26.   Makefile    The original UNIX Makefile, unmodified for historic reasons
  27.   SMakefile    The Makefile for SAS/C++ 6.51
  28.   README    Preston Brigg's original README file
  29.   ami_nuweb_086.readme    Tomas Willis's AmiNet description for NuWeb 0.86
  30.   ami_nuweb0.87b.readme    This file
  31.   literate.bib    A BibTeX bibliography of literate programming references
  32.   nuweb.w    The NUWEB source for NUWEB
  33.   nuweb.ch    A change file for better ANSI compliance and Amiga support
  34.   ami_nuweb.w    The merged result of nuweb.w and nuweb.ch
  35.   ami_nuweb.tex    The complete source in LaTeX format
  36.   ami_nuwebdoc.dvi    The short-form NUWEB user manual in .dvi form
  37.   global.h    A header file used globally
  38.   main.c pass1.c latex.c html.c output.c input.c scraps.c
  39.     names.c arena.c global.c
  40.         Source files generated by NUWEB
  41.   catalogs/nuweb.cd    Catalog description with the English texts
  42.   catalogs/nuweb.d.ct    Catalog translation with the German texts
  43.   catalogs/nuweb.h    Header file with the English texts
  44.   catalogs/deutsch/nuweb.catalog    German system catalog
  45.  
  46. This port was done and completely tested with SAS/C++ version 6.51 on an
  47. Amiga 2000 by Andreas Scherer, Roland-Stra▀e 16, 52070 Aachen, Germany.
  48. I started from Tomas Willis's work, switched to NUWEB 0.87b immediately
  49. after, and added some parts of my own.  Thanks to Preston Briggs for the
  50. NUWEB system and to Tomas Willis for the first draft of the (S)Makefile
  51. and the `temp_file+=2' hack (I most certainly would have missed this bit).
  52. Thanks to the people at Commodore Ltd. (deceased) for the Amiga and its
  53. operating system 37.175 that provided the possibility of extensible
  54. multilinguality.  Thanks to the people at SAS Institute for the terrific
  55. SAS/C development system.
  56.  
  57. After porting NUWEB 0.87b to the Amiga on Thursday, October 6, and
  58. uploading the port to both AmiNet and CTAN on Friday, October 7, I started
  59. playing around with NUWEB on the following weekend.  Although I normally
  60. like what CWEB does to the C code I write, NUWEB immediately got me hooked.
  61. Being used to writing C programs with Levy's CWEB in my native language,
  62. German, I wanted NUWEB to provide support for other languages than the
  63. default English as well.  This resulted in several hours of work to locate
  64. and localize all strings used in NUWEB for terminal output and LaTeX output.
  65. This works for the Amiga port only, on other systems the default behaviour
  66. will be present. It proved to be an advantage that NUWEB creates the output
  67. format by hard-coded LaTeX macros instead of by an external macro file.  To
  68. create NUWEB programs in German, you only have to set the system language
  69. to German.  There is no command line option to control this feature.  At
  70. the time of writing no other languages than English and German are installed.
  71. Should someone create translations for other languages as well, I really
  72. would appreciate to receive a copy for inclusion in future distributions.
  73.  
  74. October 9, 1994
  75.